home *** CD-ROM | disk | FTP | other *** search
/ Amiga Raytracing 1 / Amiga Raytracing 1.iso / cinema-4d-demo / bilder / vt.doc < prev    next >
Text File  |  1994-07-17  |  25KB  |  681 lines
  1.  
  2.                                     Viewtek
  3.        A freely distributable picture and animation viewer for the Amiga
  4.                         (Another fine UBTASITE product)
  5.  
  6.                           Written by Thomas Krehbiel
  7.  
  8.                      Copyright © 1992,1993 Thomas Krehbiel
  9.                               All Rights Reserved
  10.  
  11.        (Notice how the 'tek' in Viewtek is not capitalized in any way.)
  12.  
  13. -----------------------------------------------------------------------------
  14.  
  15. If you like Viewtek, and you are of the opinion that if a programmer
  16. writes *one* good program, then *all* programs by that same programmer
  17. must be good, then take a look at ImageFX, too.  :)
  18.  
  19. -----------------------------------------------------------------------------
  20.  
  21. IMPORTANT, CRITICAL, VITAL-TO-NATIONAL-SECURITY NOTES
  22. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  23.    Many people reported crashes playing hires overscan animations; this
  24. version does not seem to be doing this, however I was only able to duplicate
  25. this problem once under less-than-ideal circumstances with the previous
  26. version.  I'm sure I can count on you people to let me know if it still
  27. crashes. :)  Sorry for any inconvenience.
  28.  
  29.    Throughout this document you will find information on (most of) the
  30. new features, including datatypes, XPK support, and playing animations
  31. from hard drive.  I've tried to mark new items with a "(1.05)" so you
  32. can search for them with a text editor.
  33.  
  34.    Also, see the important note under DISTRIBUTION below.
  35.  
  36.    (See the end of this document for changes since the previous version.)
  37.  
  38.  
  39. INTRODUCTION
  40. ~~~~~~~~~~~~
  41.    Some of you may remember an ILBM/ANIM viewer program I wrote a while back
  42. called "TIV".  Some would say that "Viewtek" is TIV 2.0, but I consider it a
  43. totally different and much improved program (no part of TIV is in Viewtek; it
  44. is all rewritten from scratch).  (If you're using TIV now under 2.0 I
  45. *strongly* suggest you dump it in favor of Viewtek.)
  46.  
  47.    Viewtek was written with a few objectives in mind.  I wanted a program
  48. that first and foremost was totally 2.0 (and 3.0) compatible. I wanted it to
  49. take advantage of 3.0 and the AGA chips wherever possible.  I wanted it to
  50. show ANIMs as good or better than TIV did, with support for any and all
  51. display modes.  I also wanted to be able to render decent (if not
  52. spectacular) representations of 24-bit ILBMs, GIFs, and JPEGs.  And I wanted
  53. to keep the program internally modular enough to support 3rd party display
  54. devices fairly easily (I don't find this goal terribly useful anymore
  55. now that I have an A4000, but it's still there just in case).
  56.  
  57.    The result you have before you.
  58.  
  59.  
  60. FEATURES
  61. ~~~~~~~~
  62.    o Requires Workbench 2.04 or greater.
  63.    o Shows most ILBM's (including 24-bit ILBM's).
  64.    o Shows most Compuserve GIF format images.
  65.    o Shows most JFIF format JPEG images.
  66.    o Shows most ANIM Op5/Op7 format animations, with support for
  67.      different palettes for each frame.
  68.    o Supports SHAM, CTBL, and PCHG images.
  69.    o Full support of ECS/AGA display modes (ie. show 256 color GIF's
  70.      directly, show 800x600xHAM animations, etc.).
  71.    o Supports viewing contents of clipboard.
  72.    o Iconifies to a Workbench AppIcon.
  73.    o Can play animations directly from hard drive.
  74.    o Supports the XPK compression package.
  75.    o Includes a version written for GVP's Impact Vision 24, to support
  76.      true 24-bit display.
  77.    o And even includes a stripped-down version that doesn't show GIF's
  78.      or JPEG's for those who don't need it.
  79.  
  80.  
  81. NOTE
  82. ~~~~
  83.    I have no intention of supporting ANIM8 as long as there is an infinitely
  84. superior ANIM7 format around.  You, the animation user, would be wise to
  85. petition those who would use ANIM8 to use ANIM7 instead.  Unless you *want* a
  86. less efficient animation format.  'Nuff said.
  87.  
  88.    The included utility MakeAnim7 can be used to convert existing animations
  89. (5's or 8's) into the ANIM7 format.
  90.  
  91.    I have also included the documentation I received that describes the
  92. ANIM7 format.  To the best of my knowledge, there are no limitations on
  93. its distribution.
  94.  
  95.  
  96. DISTRIBUTION
  97. ~~~~~~~~~~~~
  98.    Viewtek is being distributed as Freeware.  It may be freely distributed to
  99. any bulletin board service, network, or public domain collection, so long as
  100. no fees (beyond reasonable media fees) are charged for its distribution (that
  101. is, no fees are charged for Viewtek).  I'm not asking for donations on this
  102. one, but feel free to drop me a note (preferably e-mail) or something if you
  103. want.
  104.  
  105.    Note, however, that Viewtek is NOT public domain.  The author retains all
  106. rights to the program.
  107.  
  108.    IMPORTANT:  If you want to include Viewtek with any sort of commercial
  109. distribution, you are free to do so as long as the following files are
  110. included somewhere in your distribution (and not modified):
  111.  
  112.       VT
  113.       VT.info
  114.       VT.doc
  115.       VT.doc.info
  116.  
  117.    It is not necessary that you contact me to get my permission; I hereby
  118. grant permission to any and all who wish to use Viewtek as a picture and/or
  119. animation viewer for any commercial or non-commercial purpose.  See another
  120. important note under AUTHOR below if Viewtek doesn't quite meet your needs
  121. for a picture viewer.
  122.  
  123.  
  124. OOPS!
  125. ~~~~~
  126.    Older versions of the Viewtek documentation left out a very important
  127. statement:
  128.  
  129.    This software is based in part on the work of the Independant JPEG Group.
  130.  
  131.    I'd just like to apologize to the Independant JPEG Group for not having
  132. included this, they deserve full credit for their work in bringing this
  133. popular compression format to the computer world at large.
  134.  
  135.  
  136. INSTALLATION
  137. ~~~~~~~~~~~~
  138.    Viewtek requires no special libraries or fonts or anything to run. Simply
  139. drag the Viewtek icon to wherever you wish to install it.  It may be run from
  140. a Shell, Workbench, or even your favorite dirutil.
  141.  
  142.    The IV-24 version of Viewtek, however, requires that you have a copy of
  143. GVP's "fye.library" in your LIBS: directory.  (If you have an IV-24, chances
  144. are pretty good you have this installed already.)
  145.  
  146.  
  147.  
  148. DISABILITIES
  149. ~~~~~~~~~~~~
  150.    Okay, what *doesn't* it do?
  151.  
  152.    - No color cycling (yet?).  Why?  I have exactly one picture that
  153.      color cycles out of hundreds of images and I never look at it
  154.      anyway, so it wasn't a high priority.
  155.  
  156.    - Some CTBL images may not quite show properly, more than likely
  157.      due to more palette changes per line than can be shown properly
  158.      with the copper.  Same may be true for SHAM pictures.  I probably
  159.      will not fix this because I don't really see much value in these
  160.      types of pictures anyway.  It may help to force the images
  161.      to be shown in NTSC/PAL on an A4000, or move the picture
  162.      to the right (with control arrow keys).  With better displays
  163.      becoming more widely available, this is also not a priority
  164.      to work on.
  165.  
  166.    - Does not (yet?) support a non-existant first-frame BODY as
  167.      specified for ANIM7 animations.  (Personally, I think this is
  168.      a bad thing anyway.)
  169.  
  170.    - Known incompatibility:  VT doesn't interact well with the Commodore
  171.      mouse blanker supplied with 3.0 when showing animations.  When
  172.      you move the mouse after it has been blanked (eg. after hitting some
  173.      keys during the animation), the screen goes black.
  174.  
  175.  
  176.  
  177. DATATYPES AND YOU (1.05)
  178. ~~~~~~~~~~~~~~~~~~~~~~~~
  179.    Viewtek 1.05 makes use of 3.0's datatypes.library.  This means that when
  180. VT runs across a file it is not capable of reading, it then asks datatypes
  181. to try and read the file.  If it can, then VT will still be able to show the
  182. file.
  183.  
  184.    If you want VT to use datatypes exclusively (ie. not try to identify or
  185. decode the files within VT at all), use the "DT" option on the command line.
  186. This lets you, for example, use the GIF datatype instead of VT's own GIF
  187. decoding.
  188.  
  189.    VT has been tested successfully with the GIF and PCX datatypes. (These
  190. are the only ones I have.)
  191.  
  192.    NOTE:  Processing files via. datatypes works a little differently than
  193. things normally work in VT... there is no way to abort reading a file, and
  194. the file is read entirely into memory before even opening a display screen.
  195.  
  196.  
  197.  
  198. SHOWING COMPRESSED FILES (1.05)
  199. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  200.    Viewtek 1.05 supports the XPK compression package (a nice package, BTW),
  201. allowing it to read any kind of encoding scheme that XPK itself supports.
  202.  
  203.    In order to continue using iffparse.library and in generally keep VT the
  204. way it is, it works a little strangely; the encoded file is decompressed to
  205. a temporary file in T:, which is then shown normally by Viewtek.  Obviously,
  206. this could impose some memory problems if your T: directory happens to be in
  207. RAM:.
  208.  
  209.    You'll have to get the XPK package elsewhere; consult a BBS near you (I
  210. got it from BIX).
  211.  
  212.  
  213. PLAYING ANIMATIONS FROM DISK (1.05)
  214. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  215.    Viewtek 1.05 can play animations directly from disk... sort of.  How well
  216. it works depends on many factors:
  217.  
  218.       - The speed of your computer.
  219.       - The speed of your hard drive and/or controller.
  220.       - The complexity/resolution of the animation.
  221.       - The chosen playback rate.
  222.       - The chosen buffer size.
  223.       - How much you're willing to fiddle with parameters.
  224.  
  225.    Here's an overview of how it works:  Playback from disk is done with two
  226. tasks; one task is responsible for reading data from disk, the other task is
  227. responsible for decoding and displaying the frames.  Basically, while the
  228. disk reader is getting data from disk, the playback task is playing the
  229. frames from the previous batch.
  230.  
  231.    Buffer Size.  The buffer size is very important to the performance of the
  232. playback.  The idea is to make the buffer size such that a new batch of
  233. frames can be read from disk faster than VT can play the frames from the
  234. previous batch.  If the buffer size is too small, VT will end up stuttering
  235. during playback because it has to wait for the disk reader to catch up to
  236. the playback task.  However, if the buffer size is too large, a lot of
  237. wasted time will be spent reading from the hard drive (on my system, reading
  238. from the drive for extended periods of time also causes the animations to
  239. stutter - not sure if this is just my own HD or a universal problem tho).
  240.  
  241.    (NOTE:  Animations with large deltas will require larger buffer sizes.
  242. Viewtek will inform if you need to increase the buffer size (and give you
  243. an approxiamate target size).)
  244.  
  245.    Playback Rate.  A good way to smooth out the playback is to slow down the
  246. playback rate.  This will give the disk reader task more time to read from
  247. the disk.
  248.  
  249.    Animation Complexity.  Let me be blunt:  If you think a 736x480, HAM8
  250. animation of a camera pan is going to animate well, you're crazy.  The
  251. Amiga's good, but it ain't *that* good.  :)
  252.  
  253.    Computer Speed.  Obviously, the faster your computer, the better the
  254. results are going to be.  I personally haven't tried VT on a system equipped
  255. with less than a 68040 for quite some time, so I can't really comment on
  256. whether it will even work at all on a 68000.
  257.  
  258.    Hard Drive Speed.  I've tried HD playback on two systems:  One is an
  259. A4000 with the internal IDE drive, along with a GVP SCSI controller and a
  260. Maxtor drive.  The other is an A2000 with a GVP G-Force 040 (SCSI controller
  261. built-in) and a couple Quantum drives.  (Funny how I have all this GVP
  262. stuff, ain't it? :)  The results I get are generally pretty good, although
  263. stuttering animations definitely do happen.  Fiddling with the playback rate
  264. and buffer size usually helps in all but the most severe cases though.
  265.  
  266.    In short, if you have a 1MB A500 and want to genlock your 40MB HAM
  267. interlace animations onto videotape for production work, you'll be
  268. disappointed.  This feature is strictly a novelty at this point.
  269.  
  270.    CAVEATS:  The Up Arrow does not work when playing anims from disk, and
  271. the animations are always played in "continuous" mode; ie. if the anim
  272. doesn't have loop frames it's going to look pretty strange.
  273.  
  274.  
  275. COMMAND LINE OPTIONS
  276. ~~~~~~~~~~~~~~~~~~~~
  277.  
  278.    Note that all options now have (hopefully) convenient two-letter
  279. abbreviations in case you don't like to do a lot of typing. (1.05)
  280.  
  281.  
  282.    FILE HANDLING OPTIONS
  283.    ~~~~~~~~~~~~~~~~~~~~~
  284.  
  285.    Files/M
  286.  
  287.       One or more files, directories, or patterns.  If you give VT a
  288.       directory, all files in that directory will be shown (in no
  289.       special order).  Standard AmigaDOS wildcards are supported.
  290.       Basically, anything that is not a recognizable option is assumed
  291.       to be a file spec.
  292.  
  293.    AL=All/S
  294.  
  295.       Tells VT to recursively enter subdirectories.
  296.  
  297.    CL=Clip/S
  298.  
  299.       Read image from clipboard.
  300.  
  301.    DE=Delay/K/N
  302.  
  303.       Number of seconds to show each picture or animation before
  304.       automatically proceeding to the next one.  The timer doesn't
  305.       start until *after* the picture or animation has been loaded.
  306.  
  307.    DT=DataTypes/S (1.05)
  308.  
  309.       Force VT to use Datatypes to identify and display files (normally
  310.       datatypes is the last thing checked before giving up on a file).
  311.       This lets you, for example, use a datatypes GIF converter instead
  312.       of the one built into VT.
  313.  
  314.    FO=Forever/S
  315.  
  316.       Repeat showing the list of files given on the command line
  317.       forever and ever amen (and/or until cancelled).
  318.  
  319.    IL=ILBM/S
  320.  
  321.       Force VT to assume all files are ILBM pictures.  In case you only
  322.       want to show the first frame of an animation and not the whole
  323.       thing.
  324.  
  325.    RE=Repeat/K/N
  326.  
  327.       Repeat showing the list of files given on the command line
  328.       the number of times specified (or until cancelled manually).
  329.  
  330.    SA=Save/K
  331.  
  332.       Save the resulting image that VT renders to a displayable
  333.       ILBM file.  Makes VT into a (*very*) simple file conversion
  334.       utility.  (NOTE: I have no plans to turn VT into a killer
  335.       awesome amazing wonderful convert-anything-to-everything-
  336.       else file converter.)
  337.  
  338.    UT=Unit/K/N
  339.  
  340.       Specify clipboard unit when showing contents of clipboard.
  341.  
  342.  
  343.    ANIMATION OPTIONS
  344.    ~~~~~~~~~~~~~~~~~
  345.  
  346.    BU=BufSize/K/N (1.05)
  347.  
  348.       Sets the buffer size when playing animations directly from
  349.       hard drive, in KB (ie. BUFSIZE 128 == 128KB).  VT actually
  350.       allocates 3 of these buffers, so don't get too crazy.  Also
  351.       see the notes on playing animations from disk elsewhere in
  352.       this document.
  353.  
  354.    CO=Cont/S
  355.  
  356.       Force animations to be considered "continuous".  My definition
  357.       of a "continuous" animation is one that has those two looping
  358.       frames stuck on the end (like the kind that DPaint always
  359.       creates).  Normally, VT will only consider an animation to be
  360.       continuous if a DPAN chunk is found.
  361.  
  362.    DI=Disk/S (1.05)
  363.  
  364.       Force animations to be played directly from disk.
  365.  
  366.    FP=FPS/K/N
  367.  
  368.       Specify animation playback rate in frames per second.
  369.  
  370.    LP=Loop/K/N
  371.  
  372.       Number of times to loop an animation before continuing on with
  373.       the next file.  Normally, VT will loop until you tell it to
  374.       stop.
  375.  
  376.    MA=MaxFrames/K/N (1.05)
  377.  
  378.       Maximum number of frames to read from an animation.  This is
  379.       handy if you don't quite have enough memory to load an entire
  380.       animation, or for some reason the anim is corrupted beyond
  381.       repair halfway through; VT will only read in the number of
  382.       frames you specify before going on to show it.
  383.  
  384.    ND=NoDisk/S (1.05)
  385.  
  386.       Never show animations from disk.  Normally, VT will try to play
  387.       an animation from disk if it sees you don't have enough memory
  388.       to play the animation from RAM.
  389.  
  390.    SP=Speed/K/N
  391.  
  392.       Specify animation playback rate in jiffies per frame (one
  393.       jiffy is 1/60th of a second).
  394.  
  395.    PA=Paused/S
  396.  
  397.       Begin animations in paused mode; you must hit the right or
  398.       down arrow to actually begin playing the animation.
  399.  
  400.  
  401.    DISPLAY MODE OPTIONS
  402.    ~~~~~~~~~~~~~~~~~~~~
  403.  
  404.    DF=Default/S
  405.  
  406.       Force pictures and animations to use the DEFAULT monitor id.
  407.       This is handy when you have mode promotion on, but a picture
  408.       you are showing is hard-coded as NTSC... this option forces
  409.       the picture to use the default monitor id, which in turn
  410.       causes it to be mode promoted.
  411.  
  412.    HI=Hires/S
  413.  
  414.       Force pictures and animations into HIRES.  Use with caution;
  415.       some viewmode combinations are not allowed on non-AGA machines.
  416.  
  417.    LA=Lace/S
  418.  
  419.       Force pictures and animations into INTERLACE.
  420.  
  421.    LO=Lores/S
  422.  
  423.       Force pictures and animations into LORES.
  424.  
  425.    NL=NoLace/S
  426.  
  427.       Force pictures and animations into NON-INTERLACE.
  428.  
  429.    NS=NoScroll/S
  430.  
  431.       Disable autoscrolling large pictures.  Why?  Beats me.
  432.  
  433.    NT=NTSC/S
  434.  
  435.       Force pictures and animations to use the NTSC monitor id.
  436.  
  437.    PL=PAL/S
  438.  
  439.       Force pictures and animations to use the PAL monitor id.
  440.  
  441.    S7=Super72/S
  442.  
  443.       Force pictures and animations to use the SUPER72 monitor id.
  444.       Generally only useful on AGA machines.
  445.  
  446.    SC=ScreenMode/K
  447.  
  448.       Specify the name of any available screen mode to show pictures
  449.       and animations in.  The name must be exact, as shown in the
  450.       preferences ScreenMode program (be sure to put quotes around
  451.       the name if it has spaces in it).  Case is not sensitive.
  452.  
  453.    SU=SuperHires/S
  454.  
  455.       Force pictures and animations into SUPERHIRES mode.
  456.  
  457.    UN=Underscan/S (1.05)
  458.  
  459.       Disables overscan for any pictures or animations that VT shows,
  460.       this lets you see all the way to the edges of super bitmap
  461.       pictures.
  462.  
  463.  
  464.    MISCELLANEOUS OPTIONS
  465.    ~~~~~~~~~~~~~~~~~~~~~
  466.  
  467.    HD=Hide/S
  468.  
  469.       Hide images while they are being decoded.  Normally, VT
  470.       shows you the images while they are being read; this option
  471.       causes VT to only show you the images when they are completely
  472.       decoded.  You probably want to set this for slideshow-style
  473.       presentations.
  474.  
  475.    IC=Iconify/S
  476.  
  477.       Start VT in iconified mode.  When iconified, a little AppIcon
  478.       appears on your Workbench, where you can drag image icons to
  479.       view them.  Double-clicking the icon gives you options for
  480.       quitting or showing files interactively.
  481.  
  482.    IN=Info/S (1.05)
  483.  
  484.       Only display information about files, do not actually display them.
  485.  
  486.    LM=LowMem/S
  487.  
  488.       Disable double-buffering of pictures.  Handy if you don't have
  489.       a lot of chip memory.
  490.  
  491.    NB=NoBusy/S
  492.  
  493.       Do not show a busy pointer at any time.
  494.  
  495.    PO=Pointer/S (1.05)
  496.  
  497.       Do not blank the mouse pointer when showing pictures.
  498.  
  499.    QU=Quiet/S
  500.  
  501.       Do not print any information to the shell.
  502.  
  503.  
  504.  
  505.  
  506. EXAMPLES
  507. ~~~~~~~~
  508. 1> VT picdir
  509.  
  510.    Show all files in the "picdir" directory.
  511.  
  512. 1> VT picdir ALL
  513.  
  514.    Show all files in "picdir", including subdirectories.
  515.  
  516. 1> VT picdir SUPER72 SUPERHIRES LACE
  517.  
  518.    Show all files in "picdir", forcing them into Super72 800x600 mode.
  519.  
  520. 1> VT myjpeg SAVE ram:mypic
  521.  
  522.    Show "myjpeg", and save the resulting screen to "ram:mypic".
  523.  
  524. 1> VT picdir HIDE
  525.  
  526.    Show all files in "picdir", but don't show each picture until it is
  527.    fully read into memory.
  528.  
  529. 1> VT picdir FOREVER DELAY 2
  530.  
  531.    Show each file in "picdir" for 2 seconds, repeat forever.
  532.  
  533. 1> VT picdir SCREENMODE "MULTISCAN:Productivity"
  534.  
  535.    Show all files in "picdir", forcing each one into Productivity mode.
  536.  
  537.  
  538.  
  539. USEAGE FROM WORKBENCH
  540. ~~~~~~~~~~~~~~~~~~~~~
  541.    All of the options above may be used (except Files/M) as a tool type.
  542. (Not the abbreviated form, the spelled out form.)  The following additional
  543. tool type may be set:
  544.  
  545.    DEFAULTDIR     Choose default directory where file requester opens.
  546.  
  547.  
  548.  
  549. VIEWING COMMANDS
  550. ~~~~~~~~~~~~~~~~
  551.    ESCAPE         Abort viewing immediately.
  552.  
  553.    BACKSPACE      Abort viewing current directory (when using 'ALL').
  554.  
  555.    LMB/RMB        Go to next picture.
  556.  
  557.    SPACE          Will hold on the current picture, when using DELAY.
  558.  
  559.    S              Will save the currently displayed picture as an
  560.                   ILBM (you will be asked for an output filename).
  561.                   This only works on pictures; not animations (yeah,
  562.                   I know it would be nice to save frames from anims,
  563.                   but gimme a break here... I've only got 2 hands. :)
  564.  
  565.    CTRL+Arrows    Move image/anim around on the display (overscan position).
  566.  
  567.    Up Arrow       (Anim Only) Return to beginning of the animation.
  568.  
  569.    Right Arrow    (Anim Only) Pause/single step animation.
  570.  
  571.    Down Arrow     (Anim Only) Resume playing animation after paused.
  572.  
  573.    C              (Anim Only) Toggle "continuous" mode.
  574.  
  575.    F1             (Anim Only) Play animation as fast as possible.
  576.    F2             (Anim Only) Play animation at 60fps.
  577.    F3             (Anim Only) Play animation at 30fps.
  578.    F4             (Anim Only) Play animation at 24fps.
  579.    F5             (Anim Only) Play animation at 15fps.
  580.    F6             (Anim Only) Play animation at 12fps.
  581.    F7             (Anim Only) Play animation at 10fps.
  582.    F8             (Anim Only) Play animation at 5fps.
  583.    F9             (Anim Only) Play animation at 1fps.
  584.    F10            (Anim Only) Play animation at rate specified in ANIM file.
  585.  
  586.  
  587. SHAMELESS PLUG
  588. ~~~~~~~~~~~~~~
  589.    Yes, it's true, ImageFX is the greatest image processing software
  590. ever to walk the face of the earth.  Get it.  Don't make me beg... :)
  591.  
  592.  
  593. THE AUTHOR
  594. ~~~~~~~~~~
  595.    I can be reached on BIX as "tkrehbiel" if you want to email me about
  596. something (like, say, bugs).  BIX is now connected to the Internet, so my
  597. Internet address is "tkrehbiel@bix.com".
  598.  
  599.    You can also reach me on the Late Nite BBS (804-262-9944) as Tom Krehbiel
  600. (user #13).
  601.  
  602.    As a last resort my U.S. Mail address is:
  603.  
  604.       Thomas Krehbiel
  605.       10747 Surry Road
  606.       Chester, VA  23831
  607.  
  608.    WARNING:  I generally don't answer paper mail very fast (if at all), and
  609. I am also pretty slow responding to email these days.
  610.  
  611.    NOTE:  I am currently not available for any sort of programming work,
  612. including (but not limited to :) custom versions of Viewtek.
  613.  
  614.  
  615.  
  616. REVISION HISTORY
  617. ~~~~~~~~~~~~~~~~
  618. 1.05     6/17/93     MakeAnim7 now copies over unknown chunk types;
  619.                         this preserves DPaint looping/speed info.
  620.                      Shows 640x480 GIFs in Productivity mode under AGA.
  621.                      Removed V39 gfx double buffering, 'cause palette
  622.                         changing didn't seem to work.
  623.                      Added anim playing from disk... of sorts.
  624.                      Added 'S' to save picture being displayed.
  625.                      Now supports XPK to read crunched files.
  626.                      Now supports datatypes to read unknown file types.
  627.                      New two-letter abbreviations for all options.
  628.                      Added UNDERSCAN, INFO, and POINTER options.
  629.                      Revised this documentation a bit.
  630.  
  631. 1.04a    3/14/93     Fixed DEFAULTDIR tool type to actually work.
  632.                      SAVE works on ILBM's without memory gurus.
  633.                      *Doesn't* call BestModeID under < V39 anymore... :)
  634.  
  635. 1.04     3/9/93      Supports ANIM7 (short & longword) animations.
  636.                      Supports ANIM brushes.
  637.                      Now uses the latest version of Tom Lane's JPEG code.
  638.                      Fixed SAVE option (CMAP specifically) under < V39.
  639.                      Added SUPER72, SUPERHIRES, and SCREENMODE keywords.
  640.                      Changed the way it picks JPEG viewmodes.
  641.                      Tells you how many frames are in the anims it plays.
  642.                      Now uses new graphics double buffering under V39.
  643.                      Added PAUSED option for animations.
  644.                      Added a FPS option to set frame rate in fps.
  645.  
  646. 1.03b    1/10/93     Now allows showing directories via. file requester.
  647.                      Shows >= 800x600 GIF's in Super72 mode if available.
  648.                      More robust error messages on display open fail.
  649.                      Now uses BestModeID to show undisplayable modes.
  650.                      Doesn't close screen on first click of LMB after inactivity.
  651.  
  652. 1.03a    12/15/92    Fixed unbelievably stupid bug in AppIcon stuff.
  653.  
  654.  
  655. 1.03     12/10/92    Fixed hanging locks when used as AppIcon.
  656.                      Added LORES,NOLACE,ILBM options.
  657.                      Always sets autoscroll now, and still centers 'em.
  658.                      Added NOSCROLL option to disable autoscroll.
  659.                      Added SAVE option to save rendered pictures.
  660.                      Handles animation playback a bit better.
  661.  
  662. 1.02a    11/25/92    More accurate overscan calculation.  (Maybe not)
  663.  
  664. 1.02     11/24/92    Stock version renders to HAM8 mode if available.
  665.                      Oops, fixed so you can select just one file from ASL freq.
  666.                      Fixed problem with VT's abort "sticking".
  667.                      Fixed problems with centering AGA animations.
  668.                      Added NTSC/PAL/DEFAULT options.
  669.                      Now examines DPAN chunks for frame rates.
  670.                      Fixed problems with 'odd' sized anims on AGA.
  671.                      Defers allocating ASL struct until needed.
  672.                      More generalized copper stuff.
  673.  
  674. 1.01     11/10/92    Now more intelligent about picking JPEG viewmodes.
  675.                      Handles ANIMs with masking planes.
  676.                      Now able to respect ANIM's reltime by pressing F10.
  677.                      Added busy pointer while loading images.
  678.  
  679. 1.00     11/4/92     Initial version.
  680.  
  681.